eFAWATEERcom BANK API
Add Customer Billing
URLs :
Description : This service allows the channel or Bank itself to add a Postpaid billing account for a particular customer with biller information.
Channels or Bank that want to add Postpaid billing account for a customer will pass the Add postpaid customer Billing request to the mule service, mule service will in turn call the eFAWATEERcom endpoint to add the Postpaid billing account request and eFAWATEERcom will add the billing account for that customer.
Mulesoft Request:
Mandatory Headers: x-channel-id,x-client-trace-id, x-bank-id,client_id, client_secret
Optional Headers: x-sub-channel-id, x-user-id, Authorization, x-debug-flag, x-customer-id
Request Body: application/json
Field Name | Type | Length | Occurrence | Description |
---|---|---|---|---|
addCustomerBilling | Object | M | ||
acct | Object | M | ||
joebppsNo | integer | 10 | Represents the unique identifier of the customer profile in eFAWATEERcom | |
billingsRec | Object | M | ||
billingRec | Object | M | ||
billerCode | Integer | 3 | M | Represents the unique code of the Biller |
billingNo | string | 50 | M | Represents the unique identifier of subscription in a specific service provided by the biller |
serviceType | string | 25 | M | Represents the service type of the biller |
nickName | string | 50 | O | Represents the Nike name of the customer billing |
End of billingRec | ||||
End of billingsRec | ||||
End of acct | ||||
End of addCustomerBilling |
{
"addCustomerBilling": {
"acct": {
"joebppsNo": "3172312341232",
"billingsRec": {
"billingRec": {
"billerCode": "13",
"billingNo": "07999999999",
"serviceType": "Electricity"
}
}
}
}
}
Mulesoft Response:
Success Response: (200)
Response Body: application/json
Field Name | Type | Length | Occurrence | Description | Validation |
---|---|---|---|---|---|
status | Object | M | |||
success | Boolean | M | true false | ||
code | String | 10 | M | Error Code | “0” incase of success or Error Code |
reasonCode | String | 50 | O | Error Type or Error category | Add this tag only incase of error |
arabicMessage | String | 200 | M | English message translated to Arabic | تمت العملية بنجاح in case of success or arabic translated error in case of known errors |
englishMessage | String | 200 | M | Description about the processing | “The Operation has been Successfully Completed” Or error Description |
End of status | |||||
response | Object | O | Exists if success = true | ||
addCustomerBilling | Object | M | |||
acct | Object | M | |||
joebppsNo | Integer | 10 | Represents the unique identifier of the customer profile in eFAWATEERcom | ||
result | Object | ||||
errorCode | string | 3 | M | ||
errorDesc | string | 100 | M | ||
severity | Enum, string | 7 | M | Enum: Error, Info | |
End of result | |||||
billingsRec | Object | M | |||
billingRec | object | M | |||
billerCode | Integer | 3 | M | Represents the unique code of the Biller | |
billingNo | string | 50 | M | Represents the unique identifier of subscription in a specific service provided by the biller | |
serviceType | string | 25 | M | Represents the service type of the biller | |
nickName | string | 50 | O | Represents the Nike name of the customer billing | |
result | Object | M | |||
errorCode | string | 3 | M | ||
errorDesc | string | 100 | M | ||
severity | Enum, string | 7 | M | Enum: Error, Info | |
End result | |||||
End of billingRec | |||||
End of billingsRec | |||||
End of acct | |||||
End of addCustomerBilling | |||||
End of Response |
{
"status": {
"success": true,
"code": "200",
"arabicMessage": "تمت العملية بنجاح",
"englishMessage": "The Operation has been Successfully Completed"
},
"response":{
"addCustomerBilling": {
"acct": {
"joebppsNo": "3172312341232",
"result": {
"errorCode": "0",
"errorDesc": "Success",
"severity": "Info"
},
"billingsRec": {
"billingRec": {
"billerCode": "13",
"billingNo": "07999999999",
"serviceType": "Electricity",
"result": {
"errorCode": "0",
"errorDesc": "Success",
"severity": "Info"
}
}
}
}
}
}
}
Sample Error Response:
Error codes :
400:
content-type: JSON
{
"success": false,
"code": "400",
"reasonCode": "Bad Request",
"arabicMessage": "اقتراح غير جي",
"englishMessage": "joebppsNo invalid"
}